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LNTRODUCTLON 


This document describes the Resource Control Package (rcp_), 
a proposed new interface for device and volume management. rcp. 
will exist within the security kernel and execute in ring 1. It 
is strictly an internal interface and will be documented only in 
PLS « rep. will maintain a list of most of the devices and all 
of the volumes known to the = system. rcp. will provide the 
interface to ioi_ (see MTB-056) for the attachment and detachment 
of devices. It will perform the tape drive and tape reel 
management functions mentioned in MTB-109. 


This document will describe the initial implementation of 
rep_e rcp_ should be installed before ioi_ is used as a standard 
system interface. In order for it to be available as soon as 
possible, the initial implementation will provide only those 
device and volume services that are immediately necessary. It is 
noped, however, that the interfaces described in this document 
will be correct and permanent. All the interfaces described in 
tnis document will be supported in some manner in the initial 
implementation. However, in some cases, full support will not be 
available until later implementations. Such cases will be noted. 
in the document. It is expected that additional capabilities: 
will be provided by rcp. at a later time. The important 
consideration in the initial implementation of rcp_ is that all’ 
of the I/O modules that will call rep. use an interface that will | 
change as little as possible. rcp. will be made to work, then in 
the future, the many desirable enhancements to rcp_ can be 
implemented. . 


This document contains sections on device management, volume 
nanagement, calling sequences, a sample scenario, and planned 
extensions to rcp_e Following this document will be several 
additional AMTBs that will describe parts of rcp. in more detail 
ana will describe improvements and extensions to rcp_. 


Multics Project internal working documentation. Not to be reproduced or 
distributed outside the Multics Project. 
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QEYICE MANAGEMENT 


The initial implementation of rep: will perform Lhe . 
following device management functions: 


1. assignment and unassignment 

2. attachment and detachment 

3. special control functions 

4. access control | | 
5. maintenance of device information 


BCP Data Base 


In order to perform its device management functions, rep_ 
Nill maintain a data base containing information about’ each 
device that can be under its control. This data base will be set 
up at system initialization time from the information found on 
the "prph" configuration cards. The exact information maintained 
about each device depends upon the generic class of the device. 
Among other things this information will includes 


1. device class 

2. device name 

3-e device model number 

+. other information from the prph card 
5. state of the device 

6. process ID if assigned 

/. disposition values 


In the initial implementation this data base will be 
reinitialized each time the system is initialized. It will not 
ne maintained across bootloads. However, since rcp. will execute 
in ring |, it will run on behalf of some process. Thus rcp_ will 
manage its data base in such a way that it can continue 
functioning when a process has terminated, even if that process 
had the rcp_ data base locked and was updating it. 


Cold goot Environment 


In the initial implementation all of rcp. will reside on the 
Multics system tape. It will be fully operational when Aultics 
leaves ring O for the first time. Thus rcp. can be used to 
manage tape drives in a cold boot’ environment. Future 
implementations: of rcp. may Support features that cannot function 
in a cold boot environment. rcp. will then be split into two 
parts. One part will reside on the Multics system tape and will 
be able to perform basic device management functions in a cold 
boot environment. The other part will not be on the Multics 
System tape. It will be initialized when a more suitable process 
environment is available. The interfaces to rcp. will be the 
Same regardless of the environment in which it is running. 
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Qevice Classes 


Each device managed by rep. is considered to be a member of 
a generic device class. The device classes that rcp. will 
support in its initial implementation are listed below. Future 
implementations may support additional device classes. The 
current device classes aret 


Lape (magnetic tape) 

printer (line printer) 

punch (card punch) 

reader (card reader) 

console (operator’s console) 
Wevice Names 


Each device managed by rcp. will have a unique device name. 
In the initial implementation this implies that the device name 
has been registered with ioam_. This will be done at system 
initialization time. Any caller that asks rep. to assign a 
specific device (as ‘opposed to asking rcp. to assign any 
appropriate device from a device class) will have to know the 
correct name of the device. 


Device names are derived from the names found on the prph 
configuration cards. For devices that have exclusive use of a 
channel, such as printers, the device name will be the aciual 
prph configuration card name. For devices that are multiplexed 
Over one or more channels, such as tapes, the device name will 
have the form, "pppp_xx", where “pppp" is the prpn configuration 
card name and "xx" is a unique identifying number. Such devices 
will be numbered starting from |. The maximum number is 63. 
Some examples of device names are? 


rdrb - a card reader 
tape_0O2 —- tape drive number 2 


Gates 


Gne of the primary functions of rep_ is to control access to 
loi_. Most loi. entry points can be called from the user ring 
via the gate ioi_. Certain entry points in ioi_ will be callable 
only from the administrative ring (ring 1). A special gate with 
ring brackets (0,0,!1) must be used when calling ioi_ entry points. 
that attach and detach devices or establish limits for the ioi_ 
workspace size and the ioi_ time-out interval. By permitting 
these ioi_ entry points to be callable from only the 
administrative ring, user ring programs are forced to call rcp. 
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rep. can then make the. access checks that will determine whether 
or not the action requested by the caller may be _ performed. 
Device access control will be discussed in one of the following 
sections. 


rcp_ itself may be. called via three gates. Each of these 
three gates will have ring brackets of (1i,1,5). The description 
of each rcp_ entry point will indicate which gate must be used in 
order to call that entry point. The names and general function 
of these three gates ares 


Pcp - Most rcp_ entry points can be called through 
this gate. 
rcp_priv_ - This gate will be used by system protesses to 


perform privileged administrative operations. 


rcp_tand_ - This gate will be used by special T&D processes. 
It will allow them to call special privileged 
rcep_ attachment entry points. 


Qperator Communication 


The administrative gate to ioi. will be .used by rcp. to 
access a new privileged ring O message program. This privileged 
ring O message will be callable only through this administrative 
gate. It will be called with a syserr code and a message that 
will be passed to syserr. However, it will not accept syserr 
coaqe | (crash, the system) or syserr code 2 (terminate the 
process). This new ring O message is needed by the initial 
implementation of rcp_ in order to communicate with the operator. 


Wevice Assignment aod Wnassignment 


Device assignment involves the allocation of a device to a 
specific process. The process, in a sense, will have temporary 
ownership of the device for tne duration of the assignment. The 
device will be unavailable to all other processes. Atiachment is 
a separate function which is described below. 


Unassigning a device involves taking a device away from a 
process. If .a device is attached when it is being unassigned, 
rcp_ will first detach the device. When a process terminates, 
the answering service will make a special call to recp_ 
(rcp_$unassign_proc) to force the unassignment of all devices 
still assigned to the process. 


MT b=-119 | Page 5 


Device Atlachment and Detachment 


Device attachment involves making a device available for 
actual I/0 processing. For rep_, this involves calling ioi_ to 
attach the device. rep. will also call ioi_ to initialize all 
other data needed to use the device. For appropriate device 
classes, rcp. will ensure that the correct volume has been 
mounted and is ready to be used. When the attachment is 
completed the caller will have all of the information needed to 
perform I/0 on the device. 


| Detaching a device involves breaking the connection with 
ioi_ for a device. rcp. will call ioi_ to detach the device. 
ioi_ will not accept calls to perform I/0 on the device until it 
is attached again. 


The relationship between assignment and attachment is such 
Lnat assignment does not imply attachment but attachment§ does 
imply assignment. Only assigned devices can be attached. If 
rcp., is called to make an attachment to a device that is. not 
assigned, it will automatically attempt to assign the device. 
The inverse is also true, a device may be detached without being 
unassigned, however, in order to be unassigned it must be 
detached. ene 4 . 


| In the initial implementation of ioi_, a call to ioi. to 
attach a device will result in ioi. calling ioam. to assign the > 
device. Thus initially, the system-wide focal point for . the 
assignment of devices will be ioam... For some time at least, it 
will be possible to assign devices of certain classes directly 
through ioam_. Even if a device belongs to a device class which 
rep.. does support, neither rcp_ nor ioi_ will know when a_ device 
has been assigned in this way. As far as rcp_ is concerned the 
device will be available. rcp. will be able to successfully 
assign tne device. However, ioi. will not be able to 
successfully attach the device. This problem will be solved when 
all of the existing ring 0 device interface modules for device 
classes supported by rcp. have been removed. In the initial 
implementation this problem will not exist for tapes or the 
Ooperator’s console. 


special Device Conirol Functions 


In addition to device assignment and attachment, rcp_ will 
allow certain privileged processes to add and delete devices from 
tne system. I[nis, of course, can be performed only on the set of 
devices specified by the prph configuration cards. Only devices 
that have previously been deleted can be added. A device that 
has been deleted cannot be assigned dy any process. 
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The initial implementation of recp_ will provide device 
access control that is essentially the same as tnat provided by 
the current system. This means that for each device an "ad hoc# 
set of rules will be used to determine whether or not a process 
may assign a device. These rules involve checking the access 
that a process has to various gate segments. A process will be 
able to assign a device if it has "E" access to the gate that 
rcp. associates with that device. The rules for the various 
device classes are: 


tape - No special access is currently needed to assign a 
tape drive. rep. will enforce an installation 
definea limit to the number of tape drives that a 
Single process may have assigned at one time. In 
addition, rcp. will ensure that an installation 
defined gumber of tape drives are reserved for use 
by system processes. rep... considers a system 
process to be any process that has access to the 
gate npncs_. rcp. will always assign a tape drive 
to a system process if there is a free drive 
available. However, rcp. will not assign a tape 
drive to a user -process if the number of tape 
drives available is less than the number of tape 

-drives reserved for system -processes minus the 
number of tape drives currently assigned to system 
processes. Bd 


printer - Line printers will be assigned only to processes 
that have access to the gate pridcm_. 


punch - Card punches will be assigned only to processes 
that have access to the gate phcs_. 


reader - Card readers will be assigned only to process that 
have access to the gate phcs_. 


console - The operator’s console will be assigned only to 
. processes that have access to the gate rcp _tand_. 


Wevice lofermation 


rep. will contain entry points that may be called to obtain 
information about devices that are under its control. They will 
not be available in the initial implementation. These entry 
points are similiar to the entry points provided by ioam_. 
However, the corresponding entry points in ioam. will not be 
deleted. ioam. will still be the only system interface which can 
return information about all of the devices that are assigned to 
a process. In the initial implementation of rcp_ and ioi_, ioam_ 
will still be called to assign each device that is assigned by 
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rcp_e fhe opposite is not true, however, since some devices may 
be assigned through ioam_ which are not assigned through rcp_. 
For the initial implementation no changes will have to be inade to 
any program tnat calls ioam_. 


VOLUME MANAGEMENT 


The only volumes which rcp. will manage in its initial 
implementation are tape reels. A comprehensive tape reel 
management capability is planned as one of the first ‘major 
-enhancements to rcp_.e The initial implementation, however, will 
perform only limited tape reel management. A detailed 
description of the tape reel management functions tnat are 
performed by the initial implementation of rcp. will be given in 
the description of the calling sequence for the rep. Sattach_tape 
entry point. 


ENTRY POINTS 


_ This. section contains a list of the entry points in rep_. 
The description of each entry point includes the arguments that 
it accepts, a discussion of the function of the entry point, and 
any necessary notes about the entry point. The segment name 
associated with each entry point is the name of the gate that 
must be called in order to access that entry point. The standard 
error_table_ codes that may be returned by each entry point have 
not been listed. The caller-should consider any non zero error 
code returned by any rcp_ entry point as an indication of a fatal 
error. 


Qevice Assignment and Aitachbment Eniry Points 


rcep_Sassign_tape (event_id, comment, tape_info_ptr, rcp_id, 
error_code) 


ARGUMENTS8& 


event_id (Input) (fixed bin(71)) This is the iper 
event channel ID that will be used to check this 
assignment. It will be used to send wakeups that | 
Signal the possible completion of the assignment. 


comment (Input) (char(*)) This string is a comment 
that will be displayed to the operator. It will 
be displayed after rcp_ has successfully completed 
the assignment. ; 
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tape_info_ptr (Input) (ptr) <A pointer to a structure 
provided by the caller. This structure contains 
information about the tape drive that is to be 
assigned. Tnis structure is defined below. rcp 
considers.each field in this structure to be an 
input argument to rcp_Sassign tape. 
dcl | tape info based (tape_info_ptr), 
7 2 version_num fixed bin, /* le */ 
2 tape_drive char(8), Sk 2. */ 
2 tracks fixed bint /* 3. x*/ 
le version.num - This field must be set by the 
caller. It tells rcp. what version of this 
structure the caller is programmed to use. 
In the initial implementation rcp_ will 
expect il to be set to lI. 
2. tape_drive - This field should contain 
either “tape" or the device name of the 
specific tape drive tnat the caller wants to 
assign. If it contains "tape" rcp_ will 
assign any appropriate tape drive that is 
available. 
se tracks = This field represents the 
requested track type of the tape drive that 
is to be assigned. It is used only when 
tape_info.tape_drive contains "tape". The 
acceptable values are? ; 
9 => assign a 9 track drive 
7 => assign a 7 track drive 
Q => use default track type 
if this field equals OagY9 track drive will 
ve assigned by default 
rcp_id (Output) (bit(36) aligned) This is rcp_’s 
unique identifier for this assignment. It is 
valid until this assignment is terminated. 
error_code (Qutput) (fixed bin(35)) Tnis is a 
standard error_table_ code.. | 
FUNCTIONS 


rcp_Sassign_tape initiates the assignment of a tape 
drive. The tape drive that is assiqned is dependent 
upon the values in tape_info.tape_drive and 
tape_info.tracks. If tape_info.tape_drive does not 
contain “tape" then rcp. will assume that it contains 
the device name of the tape drive to be assigned. If 
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this device name does not specify a known tape drive, 
or if the specified tape drive cannot be assigned, rcp_ 
will abort the assignment. rcp. will make no attempt 
to assign any other tape drive. If 
tape_info.tape_drive does contain "tape" then rcp_ will 
assign any available and appropriate tape drive. In 
this case, rcp. will ensure that the tape drive 
assigned has Lhe track Lype specified in 
Ltape_info.tracks. 


In either case, rcp_ will consider the access thal the 
process has to nphcs_ in order to determine whether or 
not this is a system process. If it is, rep_ will 
increment the count of tape drives assigned to system 
processeS.e If it is not, rep. will ensure that the 
limit placed on the number of tape drives that may be 
concurrently assigned by all user processes is not 
exceeded. rcp_ will also enforce the limit placed on 
the number of tape drives that a single process may 
have assigned at one time. 


Each device assigned has associated with it a 
disposition value. This disposition value tells rcp_ 
whether or not the device should be unassigned when it 
is detached. When a device is assigned by an rcp. 
assignment entry point its disposition value will be 
initialized to specify that the device is not to be 
unassigned if it is detached. This disposition value 
may be overridden by subsequent calls to rep. (See 
rcp_$detach.) However, in most cases explicitly 
assigning a device via a call to an rep. assignment 
entry point implies that the device must be unassigned 
by a call to rep_sunassign. 


Tnis entry point functions in cooperation with the 
rep_Scheck_assign entry point. rep_$assignitape only 
initiates the assignment of a tape drive. When it 
returns, the drive will not yet be assigned to the 
caller’s proceésSe A call must be made Lo 
rcep_Scheck_assign in order to obtain the drive name and 
track type of the tape drive that will be assigned. 
Any attempt to attach this device before the assignment 
is complete will result in an error. (See 
rcp_Scheck_ assign.) 


NOTES: 


All of the rcp. assignment and attach entry points. 
function in cooperation with a corresponding rcp. check 
entry point. The need for the check entry points may 
nol be immediately obvious. They are needed because, 
in some cases and in future implementations, . the 
assignment or attachment functions performed by rept 
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cannot be completed without blocking and waiting for 
one or more events to occur. The check entry points 
force the caller to use a programming sequence that 
provides for repeated blocking. (See the section 
containing: the sample scenario of calls to rcp_.) The 
user must do the blocking and not rep. since rep. will 
execute ina lower ring and it is undesirable to block 
in a lower ring. The events that will be waited for 
depend upon the class of the device involved, the 
current state of the devices and volumes, and the 
implementation of rcp_. For example, the attachment of 
tape drives involves the mounting of a tape reel and 
this involves I/O operations and they involve waiting 
for wakeups from ioi_. In future implementations of 
rcp.. all device assignment functions may be performed 
by some system process and this involves waiting for 
that process to send a wakeup that signals the 
completion of the assignment. 


rcp_Sattach_tape (event_id, comment, tape_info_ptr, reeluname, 


write_flag, reg.data_ptr, rcp_id, error code) 


ARGUMENTS 


event_id (Input) (fixed bin(71)) Tnis is the ipcr 
event channel ID that will be used to check this 
altachment. It will be used to send wakeups' that 
signal the possible completion of the attachment. 
This event channel ID is passed to ioi_ when ioi_ 
is called to attach the device. rcp. treats this 
event channel ID independently from the event 
channel ID specified in any previous assignment 
call. | 


. x 
comment (Input) (char(*)) This string is a comment 
that will be displayed to the operator. It will 
be displayed after rcp_ has successfully completed 
the attachment. 


tape_infovptr (Input) (ptr) (See rcp_Sassign_tape. ) 
One minor difference exists between the way 
rep_S$attach_tape and recp_sSassign_tape use the 
tape_info structure. If tape_info.tracks equals 0 
then rcp_Sattach_tape, in later implementations, 
will look in the tape reel registration data for 
the track type of the tape drive to assign. Only 
if it is unspecified in the registration data will 
the default of 9 tracks be used. 
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reel_name (Input). (char(*)) This string contains’ the 
name of the tape reel that the caller wants 
mounted on the attached tape drive. 
write _flag (Input) (bit(1)) If this flag is ON recp_ 
will ensure that the specified tape reel is 
mounted with a write ring. If it is UFF rcp. will 
ensure that the specified tape reel is mounted 
without a write ring. | 
reg_data_ptr (input) (ptr) A pointer to a structure 
provided by the caller. This structure defines 
the tape reel registration data that is returned 
by rcepie (See the notes below.) 
rep_id (Output) (bit(36) aligned) This is a unique 
identifier that rcp_ generates when a device is 
assigned. rcp_ does nol generate a new rcp lid 
when the device is attached. It is used to 
identify the assigned device that is being 
attached. . 
error_code (Qutput) (fixed bin(35)) 
FUNCTION? | | 


rcep_Sattach_tape will initiate the attachment of a tape 
drive. The tape drive that is attached is dependent 
upon Lhe values in Lape_info.tape_drive and 


Lape_info.tracks. The basic strategy for determining 


which tape drive to attach is the same as that used by 
rcp_Sassign_tape. rep. will check to see if an 
appropriate tape drive is currently unattached but 
assigned to this process. If rcp_ finds an appropriate 
tape drive that is already assigned it will initiate 
the attachment of tnat tape drive. If rcp. cannot find 
an appropriate tape drive that is already assigned it 
will initiate the assignment of a tape drive as 
previously described. If rep. has. a choice among 
several appropriate tape drives and one of them already 
has mounted the tape reel tnat is needed for this 
attachment then rcp_ will assign that tape drive. 


Once rcp. has found an acceptable and assigned tape 


drive it will initiate tne attacnment of the device. 


rep. will call ioi_ to perform the ring 0 device 


attachment. If this is successful, rcp. will initiate 
the mounting of the specified tape reel. A tape reel 
that is mounted or is being mounted is considered to be 
assigned to the process that the associated tape drive 
1s assigned to. If the specified tapé reel is already 
assigned then rcp. will not be able to complete the 

assignment at this time. (See rep sScheck_attach. ) 
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rcp. will recognize the case where this tape reel is 
already mounted and. will not issue a redundant request 
Lo the operator to have it mounted. 


There are two subtle differences belween the case where 
a device has been explicitly assigned by a call to an 
rcp.. asSignment entry point and the case where a device 
nas been automatically assigned by an rcp. attachment 
entry point. These differences are? 


1. Assume that’ the device has been assigned 
successfully. Now assume that while attaching the 
device a fatal error occurs. The attachment will 
be abandoned. If the device was assigned by the 
attachment entry point then the device will be 
unassigned. However, if the device was previously 
assigned by an assignment entry point then it will 
remain assigned. 


Ze If the device being attached was previously 
assigned by an assignment entry point then the 
disposition value associated with this device will 
not be changed. If the device has been assigned 
by the attachment entry point then the disposition 
value for this device will be initialized to 
specify that the device is 10 be unassigned when 

it is detached. (See rcp_S$detacn.) 


This entry point functions in cooperation with the 
rep_Scheck_attach entry point. rep _$attach tape 
isnitiates the attachment but does not complete it. The 
caller still can not successfully call ioi_ to perform 
I/0 on the tape drive being attached. The attachment 
will not be completed and the caller will not know the 
device name of the tape drive that was actually 
attached until a successtul calls 1S made _ to 
rcp_$check_attach. : 


NOTES 8 


The reg_data_ptr argument should point to a= structure 
proviaed by the caller. This structure will contain 
the tape reel registration data that is returned by 
rcpie rep. will return all of the tape reel 
registration data that is needed by the tape I/0 module 
as well as all of the tape reel registration data that 
may be changed by a user process. This information is . 
returned by this entry point Tor the convenience of the 
calling tape I/O module. 


the initial implementation of rep_ will not support 
tape reel registration data. However, the fields in 
this structure will be filled in by the initial version 
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of rep. Each field will be set to a default value 


that will be valid even when the full tape reel 


management facility is available. These default values — - 


wili specify that the information associated with the 
field is not known by rcp_. The aoeeetneercn data 
structure is as follows: | 


del 1 reg_data based (reg_date oe 
2 version.num fixed bin, Se le ks 
2 volume_id © char(32), | /*k 2. */ 
2 tracks — fixed bin, -</* 3. */. 
2 density | - fixed bin, /* 4. */ 
2 label_type | fixed bing -/* 5. */ 
2 usage_count fixed bin, 7k: OO. */ 
2 read errors fixed bing Sse 1, -*/ 
- 2 write errors fixed bin3 Lk. 8B. eS 


4. version.num - (See tape _info.version_num. ) 


2. volume_id - This field will contain the volume 

ID of the tape reel. ° In the initial 

implementation rcp. will set it ‘Lo the contents of 
the reel_name argument. _ 


3. tracks - This field represents — cake track type 
specified in the registration data for this tape 
reel. In the initial implementation rcp_ will set. 

~ it to O. 


4. density - This field represents the Lape density 
specified in the registration data for thnis tape 
reel. .In the initial implementation rcp. will set 

“1t to O. 


5s label_type - This field represents the label 
type specified in the registration data for this 
tape reel. In the initial implementation rcp_ 
will set it to 0. | | | 


6. usage_count ~ This field is a count of the total 
number of times this tape reel has been attached 
by any process Since the last time the field was 
reset. The current attachment will be included in 
tnis count. In the initial implementation rcp_ 
will set it to l. 


té read_errors - This field is a count of the total 
number of read errors that have occurred with this | 
tape reel since the last time this field was 
reset. In the initial implementation rcp_ will 
set it to QO. . 
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B. Wwrite_errors - This field is. a count of the 
total number of write errors that have occurred 
with this tape reel since the last time this field 
was reset. In the initial implementation rcp_ 
will set it to O. 


rep_tand_$priv_attach_tape (event_lid, comment, tape _info_pir, 
reel_name, write flag, reg_data_ptr, rcp_id, 
error_code) : , 


ARGUMENTS 8 


This entry point has the same arguments as 
rcop_Sattacn_tape. 


FUNC1L ION? 


rep_tand_$priv_attach_tape functions basically the same 
as rcp_Sattach_tape. The only difference is that when 
rep. calls ioi_ to perform the ring O attachment of the 
tape drive it will call a privileged ioi_ attach entry 
point. This privilege is given by ioi_. With this 
privilege ioi_ will allow subsequent connect calls to 
specify a PCW as well as a list of DCWs, and to address 
device 0O. 


rep_Sassign printer (event iid, comment, printer_info_ptr, rcp_id, 
error_code) 


ARGUMENTS 8 


event_id (Input) (fixed bin(71)) 
(See rcp_sSassign_tape.) 


comment (Input) (char(*)) (See rcp_sassign tape. ) 


printer_info_ptr (Input) (ptr) A pointer Lo a 
structure provided by the caller. This structure 
is similar in format and function to the tape_info 
structure. 


del | printer_info based (printer_info_ptr), 
2 version_num fixed bin, /* 1. */ 
2 printer char(3), 1k 2. */ 
2 model fixed bin, /* 3. */ 
2 chain fixed bins /* 4, x*/ 
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ie version_num - (See tape_info.version num.) 


ce printer - This field should contain either 
‘orinter" or the device name of the specific 
printer that the caller wants to assign. If 
it contains “printer” then rep_ will assign 
any appropriate printer that is available. 


3. model ~- This field represents the requested 
model number of the printer that is to be 
assigned. - Tt is - used only when 
printer_infoeprinter contains "printer", it 
must be a value that is. found in the “model 
field of a printer prph configuration. card. 
Ir it is O rep. will not consider the model 
characteristic in its search for a printer to 
assign. 


4. chain -. This field represents the requested 
chain (print train) type of the printer tnat 
is to be assigned. It is used only when 
printer _info.printer contains "printer". it 
must be a value round in the “chain" field of 
a printer prph card. If it is 0 rep. will 
not consider the chain characteristic in its 
search for a printer to assign. 


rcp_id (Output) (bit(36) aligned) 
(See rcp _Sassign_tape.) 


error_code (Qutput) (fixed bin(35))— 


FUNCTIONS 


rcp_Sassign_printer will initiate the assignment of a 
printer. Before initiating tne assignment, rcp. .will 
verify that the calling process has. the proper access. 
The device assigned is dependent upon the fields in 
printer_info. If printer_info.printer does not contain 
“orinter" then rcp. will assume that it contains the 
device name of the printer to be assigned. If this 
device name is invalid, or if this device cannot be 
assigned, rcp. will abort Lhe assignment. If 
printer_infoeprinter does contain "printer* then rcp_ 
Will assign any available and appropriate printer. 
rep. will ensure that the printer assigned has the 
model and chain characteristics specified in 


printer _info.model and oprinter_info.chain. I[f either 


of these arguments is 0 rcp_ will not consider that 
characteristic in its search for an appropriate device. 
rep_Sassign_printer functions and cooperates with 
rep_$checkK assign in the same manner that was described. 
for rcp_Sassign tape. | 
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rcp_Sattach_printer (event_id, comment, printer_info ptr, rcp_id, 
error _code) 


ARGUMENTS? 


This entry point has. the same arguments as 
rcep_sSassign_printer. 


FUNCTION? 


rep_Sattach_printer will initiate the attachment of a 
printer. The printer that is attached is dependent 
upon the fields in printer_info. The basic strategy 
fur determining which printer to attach is the same as 
that used by rcp_sSassign printer. If rep. cannot find 
an appropriate printer that is already assigned it will 
initiate the assignment of a printer as previously 
describea. Unce rcp. has found an acceptable and 
assigned printer it will initiate the attachment of 
that printer. rcp_ will call ioi_ to perform the ring 
O device attachment. recp_S$attach_printer functions and 
cooperates with recp_scheck_attach in the same manner 
that was described for rcp_Sattach_tape. 


rcp_tand_$priv_attach_printer (event_id, comment, 
printer_info_ptr, rcp_id, error code) 


ARGUMENTS3 


This entry point has the same arguments as 
rcp_Sassign_printer. 


FUNCTION? 
rcp_tand_Spriv_attach printer has the same relationship 


to rcep_Sattach_printer that rcp_tand_Spriv_attach tape 
has to rcp_S$attach tape. = 


rcep_Sassign punch (event_id, comment, puUnch_info_ptr, rcep_id, 
error_code) 


ARGUMENTS3 
The arguments to this entry point are similar to the 


arguments to rep_Sassign printer. The only differences 
are that they reference punch devices rather’ than 
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printer devices and that there is no chain field in the 
punch info structure. | 


This entry point functions basically the same as the 
rep_.Sassignuprinter entry Cores 


rep_S$attach_punch (event_id, comment, punch_info_ptr,  rcp_id, 
error code) 


ARGUMENTS 


inis entry point nas the same arguments as the 
_rcep_Sassignipunch entry point. : 


FUNCIIUNS - 


inis entry point fTunctions basically the same as the 
rcp_Sattach printer entry. point. 


rcp_tand_Spriv_attach punch (eventlid, comment, punch_info_ptr, 
rep_id, error code) a 


ARGUMENTS 8 
ihis entry point has the same arguments as 
rcp_Sassign_puncn. 7 : 


FUNCTION: 


rep_tand_Spriviattach_puncn has the same relationsnip 
to rep_$Sattachpunch that rcp _tand_S$priv_attach_tape 
nas to rcp_Sattach_tape. 


rcp_Sassign_reader (event_id, comment, reader_infovptr, =rcp_id, 
error_code) : 


ARGUMENTS 


fhe arguments to this entry point are similar to the 
arguments to rcp_SasSign_printer. The only differences 
are that they reference card reader devices rather than 
printer devices and that there is no chain field in the 
reader_info structure. 
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FUNCTION® 


This entry point functions basically the same as the 
rep_$assign_printer entry point. 


rep_Sattach_ reader (event ~id, comment, reader_info_ptr, rcp iid, 
error_code ) | 


ARGUMENTS 8 


This entry point has the same arguments as_ the 
rcp_sassignireader entry point. 


FUNCIION: 


tnis entry point functions basically the same as _ the 
rep_Sattach_printer entry point. 


rep utand_Spriv_attach_reader (event_id, comment, reader_info_ptr, 
rep_id, error_code) 


ARGUMENTS 8 


This entry point has the same arguments) as 
rep _Sattach_reader. . 


FUNCTIONS 


rcp_tand_$priv_attach_reader has the same relationship 
to recp_Sattach_redder that rcp _tand_Spriv_attach_tape 
nas to rcp_Sattach_tape. 


rep _Sassigniconsole (event_id, comment, console_info ptr, recp_id, 
error_code) 


ARGUMENTS: 


| 
event_id (Input) (fixed bin(35)) 
(See rcep_Sassign_tape.) 


comment (Input) (char(*)) (See rcp_Sassign tape.) 


console_info.ptr ‘$(Input) (ptr) A pointer to a 
structure provided by the caller. Since current 
Multics systems have only one operator’s console, 
this . structure will not really be used when 
assigning or attaching the operator’s console. It 
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is included in this calling sequence for the sake 
of consistency and because it may be needed by 
future implementations of rcp_. : , | 


console_info based (Gonsole_info_ptr), 
2 version_num fixed bin, /* |. */ 
2 console char (8), fe 2, *f 
2 model - fixed bins /* 3. x/ 


verSion.num - (See tape_info.version_num. ) 


console - ‘Tnis field should contain 
"console". ae 
model - This field is ‘not currently used 


for assignment or attachment. When’ the 
console_info structure is filled in by 


-repuscheck_assign or. rcp _$check attach this 


field will contain one be tne following 
values. - | Bait 


1 => "“jbm" -— BCD console 
2 => "emc" — Entry Mode Console 
3 => "scc" -— System Control Center 


rep_id (Output) (bit(36) al tone dy: 
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del 1 
|e 
Ze 
a 
(See 

error_code 

FUNCTION? 


rcp_Sassign_tape.) 


(Output) (fixed bin(35)). - 


Since there is only one operator’s console available on 
tne current system, rcp_ will not have to search for an 
appropriate console device to assign. If the calling 
process has access to the gate rcp_tand_, and if the 
console is not already assigned, then rcp_ will assign 
~ the console to the calling process. A call must must 


be made 


to rep_$check_assign in order to complete the 


assignment. 


rcp_Sattach_console 


ARGUMENTS # 


(event_id, comment, console_info_ptr, rcp_id, 
error_code) | 


This entry point has the same arguments as 
rcp_Sassign_console. 
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FUNCTIONS 


rcp_Sattach_console initiates the attachment of the 
operator’s console. If the operator’s console is not 
already assigned to the calling process then rcp_ will 
attempt to assign it. Once the console has been 
' successfully assigned to this process rcp. will 
initiate the attachment of the console. Before rcp. 
can call ioi_ to attach this device, rcp. must call the 
ring O console device interface module, ocdcm_, to 
detach the console from the syserr mechanism. If the 
syserr recovery mechanism is available it will be 
enabled by ocdcm_. rcp. will then call ioi_ to perform 
the ring O attachment. In order to complete the 
aitachment the caller must call rep u$check_attach. 


rcp_tand_$priv_attach_console (event_id, comment, 
console_info_ptr, rcp_id, error _code) 


ARGUMENTS 3 


Tnis entry point has Lhe same arguments as 
rep _Sassign_console. 7 


FUNCTIONS 
rcp_tand_Spriv_atitach console has the same relationship 


Lo rep_Sattach console that rcp _tand_S$priv_attach_tape 
has to rcp_Sattach_tape. 


rep_Scheck_assign (rcp_id, device_info_ptr, state_index, 
error_code) 
ARGUMENTS 3 
rcp_id (Input) .(bit(36) aligned) This argument 


identifies the assignment request to be checked. 


device_info_ptr (Input) (ptr) A .pointer to a 
structure provided by the caller. The format of 
this structure depends upon the class of the 
device whose assignment is being checked. It 
should correspond to the structure referenced by 
the assignment call. It may or may not be in the 
same location as the structure referenced by the 
assignment call. All the fields in this structure 
except the version number will be used. as output 
arguments by rcp_. rcp. will use these output 
fields to return the device name and other 
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FUNCTIONS 


“=a 
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characteristics of the device that was actually 
assigned. | 


State_index (Quiput) (fixed bin) ~— This argument 
represents the state of the assignment. More 
detailed information about this argument is given 
‘below. The values that may be returned are? 


0 => ready 

| => short wait 
2 => long wait 
3 => fatal error 


error_code (Qutput) (fixed bin(35)) This value will 
be O unless the value of the state_index is 3. In 
this case, an error _table_ code will be returned. 


rep_$check_assign functions in cooperation with the 
rep. assignment entry points. After calling one of the 
assignment entry points another call must be made to 
this entry point. rcp_$check_assign will see if the 
assignment has been. conpreneds 2 


Ii the assignment is proceeding normally but has. not 


yet completed, the caller will be told that there is a 


short wait. A state_index value of | will be returned. 
The situations that may result in a= short wait 
condition vary for each device class. They will also 
vary with future implementations of rcp_. An example 
of a short wait situation would be: rcp_is waiting > 
for the operator to give permission to assign a printer 
to the calling process. This is a case that may 
actually happen with future implementations of rcp_. 
The caller will not be told the reason for the_= short 
wait. What the caller does Know is that, in order to. 
Signal the possible end of the short wait condition, a+. 
wakeup will be sent over the ipc_ event channel whose 
ID was passed aS an argument in the assignment call 
that is being checked. The procedure that sends this 
wakeup depends upon the situation and Lhe 


_implementation of rcp_.e It may be rcp_ itself, or it 


may be ioi_, or it may be a system process that is 
involved in the device assignment. Tne caller should 


block on this event channel whenever a stale_index of | 


is returned. When the wakeup comes through the caller 
should not assume that the assignment has been 
completed. He may correctly assume only that it might 
have been completed. He must call recp_$theck assign | 
againe This whole sequence must be repeated until 
rcp_$check_assign: returns a state_index value of O or 
indicates an error condition. © 
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If the assignment cannot be completed because the 
device (and possibly the volume) to be assigned is 
already assigned to another process, rcp. will return a 
state_index value of 2. rcp_ can make no predictions 


“about when the needed resource will become available. 
' rep_ does know that some time in the future the 


resource will be available and the assignment can be 
completed. This is the long wait case. If the caller 
chooses to wait he should block just as with the short 
wait case. Otherwise, he should call rcp.Sunassign to 
abandon the assignment. In the initial implementation 
of rep. the long wait case is not supported. Instead, | 
the caller will be told that the assignment cannot be 


made. 


“When the assignment is completed rcp_ will return the 


device name and associated characteristics of the 
assigned device. They will be returned in the 
device_info structure. The information returned by 
Trep_ $check assign will be valid only when a state_index 
value of O is: returned. 


rep_$check attach (rcp_id, = device_info_ptr, ioi_index, 


workspace_max , Limeout_max, | state _index, 
error_code) : 


ARGUMENTS: 


rcep_id (Input) (bit (36) aligned) This argument 
identifies the attachment request to be checked. 


device_info_ptr (Input) (ptr) 
(See rcp_$Scheck_assign.) 


ioi_index. (Output) (fixed bin) This is the device 
index generated by ioi.. It must be used in all 
subsequent calls to ioi_ for this device during 
this attachment. 


workspace_max (Output) (fixed bin) This is the 
maximum size of the ioi_ workspace for the 
asSigned device. ioi_ will reject any attempt to 
expand the workspace beyond this limit. 


timeout_max (Output) (fixed bin) This is the maximum 
time-out interval that ioi._ will allow. ioi_ will 
reject any attempt to set a time-out interval that 
is greater than this limit. 
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state_index (Qutput) (fixed bin) 
(See rep _$check_assign.) 


error_code (Qutput) (fixed bin(35)) 
FUNCTION: | 


reop_$check_attach functions in cooperation with the | 

rep_ attachment entry points. After calling one of the. . 
attachment entry points another call must be made to 
this entry point. rcp_$Stheck_attach will see if the 
altachment has been completed. The attachment of a 
tape drive is not complete until the requested tape 
reel is mounted and is ready for I/O processing. | 


If the attachment has completed successfully, rcp. will 
then perform the final steps necessary for the caller 
to” perform I/0 on the attached device. rcp. will call. 
ioi_ to set the maximum workspace size and the maximum 
time-out, interval. It is rcp. that defines these 
limits. ioi. enforces them. (See Appendix A. for a 
list of these limits for each device class.) rep_ will 
call ioi_ to promote the validation level for this — 
device .to...the  caller’s validation level. | 
rep $check_attach will -return the device name _ and 
associated characteristics of the device. that was 
actually attacned. This information will be returned 
in the device_info structure. I[t will also return’ the 
joi. device index and the ioi. limits that have been 
derined. it will return a state _index value of 0. The 
output arguments returned by recp_$check attach will be 
valid only when the state_index value returned is 0. 


After rcp_$check attach has indicated that the 
attachment has been completed, the caller should call- 
ioi. to set up his I/0 environment. The event channel 
ID that was passed to rep_ in the attachment call was 
in turn passed to ioi_. If the caller wants to use a 
different event channel he may now call ioi_ to change 
it. rcp... set up only the limits of the workspace size 

and the time-out interval. The caller must call ioi_ 
to establish his workspace. rep. does not return a 
pointer to the ioi_ workspace. rep. will leave _ the 
time-out interval set to the default value defined by 
-loi_. Unless the caller wants to use this default 
value he should call ioi_ to set the time-out interval 
that he wants. : 


If the attachment is proceeding normally but nas nov 
yel completed, the caller will be told that there is a 
short wait. <A state_index value of | will be returned. 

The situations that may result in a short wait vary for. 
each device class. They will also vary with future 
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ABE 


implementations of rcpie An Svausie of a short wait 
situation would bet rcp_ is waiting for a tape reel to 
be mounted and to become ready. The short and long 
wait cases that were discussed with rcp_$check assign 
are also possible with this entry noint since the 
attachment that is being checked may also have involved 


an assignment. rep _$Scheck attach will not return a 


state_index value of 0O until both the assignment and 
the attachment have been completed. (See 


_rep_schecklassign.) © 


“rep_$detach (repaid, eee disposition, error _code) 


| ARGUMENTS # 


rcep_id (Input) — (bit(36) . iabfaneai This argument 
_ identifies the eueronely attached device that is 
to be detached. | 


comment (Input) (char (*)) This ering is a comment 
that will be dispdayed to the operator after the 
device has been detached. this argument allows 
the caller to give some final instructions to the 
operator regarding this device, | 


disposition : (Input) (fixed bin) This argument 
specifies. the action to be taken by rep. with 
regard to the disposition of the device being 
detached. The disposition of the device involves 
tne possible retention of the device assignment 
even though the device is being detached. The 
legal values which this argument may have are? 


0 => unspecified 
| => unassign the device 
2 => retain the device gee tommenk; 


error_code - (Output) (fixed bin(35)), 


FUNCTIONS 


rep_édatach will Aways detach the specified. device. 
Detaching implies that rep_ will call ioi_ to detach 
this device in ring 0. The ioi._ index that had been 
associated with this device is now invalid. ioi. will 
reject all calls for this device until. it is attached 
again. . In the initial implementation. rcp_$detach will 
aiwayS unassign any volume mounted on the device being 
detached This implies that this volume may be assigned 


to another process. rep. may, or may not actually 


dismount this volume depenciay upon what it considers: 
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to be the best course of action at the time. 


If the disposition argument contains O then rcp. will 
use the current disposition value associated with the 
device in order to determine whether or not it should 
unassign the device. if the device was assigned by an 
attachment entry point then it will be unassigned. If 
the device was assigned by an assignment entry point it 
Will nol be unassigned. I/0 modules should always call 
rcp_Sdetach witn .a disposition argument of 0 unless 
they have some good reason to explicitly specify the 
disposition. 


If the disposition argument contains I then rep _Sdetach 
will always unassign the device. The rcp_id associated 
with this device will no longer be Walid. The device 
will be available for assignment to other processes. 
If the disposition argument contains 2 then rcp_$detach 


| will not unassign the device. Ihe device will still be 


assigned to the caller’s process. The recp_id 
associated with this device assignment will still be 
valid. The. device will be available for future 
attachments by this process. 


rep_Sunassign (rcp_id, comment, error_code) 


ARGUMENTS 8 


rep_id (Input) (bit(36) aligned) This argument 
identifies the device that is to be unassigned. 


comment (Input) (char(*)) (See rep _sdetach.) 


error_code (Input) (fixed bin(35)) 


FUNCTIONS 


This entry point will unassign the specified device. 
Any previous disposition specification will be ignored. 
If tne device is currently attached rcp_ will 
automatically detach it before it is unassigned. (See 
rep_Sdetach.) 
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rcp_$update_tape_reg (rep_id, reg_data_ptr, error_code) 
ARGUMENTS | 


rep_id (Input) (bit(36) aligned) This argument 
Identifies the attached tape drive on which the 
tape reel involved with this update is mounted. 


reg_data_ptr (Input) (ptr) A pointer to a =e structure 
provided by the caller. This structure defines 
the tape reel registration data that will be 
updated. See the discussion of rcp_Sattach_tape 
for a description of this structure. 


error_code (Qutput) (fixed bin(35)) 
FUNCTIONS » 


rep_Supdate_tape_reg will update the tape ree) 
registration data associated with the tape reel that is 
mounted on the specified tape drive. This entry point 
will exist in the initial implementation of rcp_ bul it 
will nol perform any update function. Even so, tape 
I/0 modules that use the initial implementation of rcp_ 
should call this entry point when il is appropriate to 
do.so.e Later documentation dealing with rcp. will 
describe which fields in the registration data 
structure are updated and the exact manner in which the 
update is made for.each field. 


Administrative Entry Points 


rcep_priv_$force_unassign (device_name, error. code) 
ARGUMENTS 8 ~ | 


device_name (Input) (cnar(*)) This argument specifies 
the name of the device that rep. is to unassign. 
It must be a legal device name that is known to 
rep_s 


error_code (Qutput) (fixed bin(35)) 
FUNCTIONS 


This entry point is called to force the unassignment of 
a specific device. This device does not have to be 
assigned to the calling process. It is expected that 
only certain privileged .system processes will have 
access to the gate through which this call must be 
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made. If the device is currently attached, rcp_ will 
detach the device before it is unassigned. In order to 
detach a device tnat is attacned to another process, 
rep_ will call a privileged entry in ioi. to force 
detach the device. loi_ will then reject any future 
calls for this device from the process that previously 
nad the device assigned. 


} 


rep_priv_$proc_unassign (process_id, error _code) 


ARGUMENTS 


process_id (Input) (bit(36) aligned) Tnis argument 
contains the process ID of a process that will 
have all of its assigned devices unassigned. 


error_code (Output) (fixed bin(35))— 


FUNCT ION3 


this entry point is_ called to unassign all of the 


_ devices rcp. nas assigned to the specified process. 


See the function description of rcep_$force_unassign for 
details about unassigning a device that is assigned to 
another process. Normally the calling process will not 
be the process that is having all of its devices 
unassigned. This entry point will be called by the 
initializer process (under the semblance of the 
answering service) whenever a process terminates. This 
is done in order to be sure that no devices remain 
assigned to terminated processes. | 


rcp_priv_$delete_device (device_name, error_code) 


ARGUMENTS: 
device_name (Input) (char(*.)) This argument 
specifies the name of the device that rcp_ is to 
delete. 


error_code (Output) (fixed bin(35)) 
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FUNCTION: 


This entry point will delete the specified device from 
the list of devices that rcp_ may assign. Tne effect 
is that this device is no longer configureaq on the 
csystem. If the device to be deleted is currently 
assigned to a process, the device will not be deleted 


until the device becomes unassigned. 


rep_priv_S$addidevice (device_name, error code) 


ARGUMENTS: 
uevice_name (Input) (char(*)) This argument 
specifies the name of the device that rcp_ is to 
add. : x 


error_code (Output) (fixed bin(35)) 
FUNCTION# 


ihis entry point will add the specified device to the 
list of devices which may be assigned by rcp_. The 
device may then be assigned to any acceptable process 
that attempts to assign it. The device being added 
must have been deleted by a previous call Lo 
rcp_priv_S$Sdelete_device. 
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QAMPLE SCENARIO 


Below is a sample scenario of calls to rep_. This example 
represents an acceptable sequence of calls to rcp_ for the 
purpose of attaching any model 301 printer. This example shows 
the relationship between the attach entry points and the 
checkK_attach entry point. The sequence of calls used to perform 
just an assignment would be very similar. 


ATTACH /* Begin attachment. */ 
(sel up event channel "ev_id" and wait list. ] 
piuwptr = addr(printer_info)3. 
pi_ptr->printer_info.version_num = 13 
pi_ptr->printer_info.printer = "printer"3 
pi_ptr->printer_info.model = 301/18 
pi_ptr->printer_info.chain = U3 
call rEp_vattach pranyer (ev _id,"Example",pi_ptr, 

rcp_id,code) } 
if code “= QQ then goto ERROR} 

CHECK_LUOP: 
call rep_$check_attach (rcp_id,pi_ptr,ix,wm,tm,sx, code); 
goto STATE(sx)3 | 

STATE (1) 8. /7*® Short wait. */ 
call ipc _$block (wliptr,muptr, code)$. 
if code “= Q then goto ERROR; 
goto CHECK LOOP $ . So 

STATE (2) 3 /* Long wait. x*/ 

[Ask user if he wants to wait. ] 
(If yes, handle long wait case.] 


STATE (3)3_ 7* Fatal error. */ 
ERRORS 
{Process error.] 
return? 
STATE (O)2 /*x Attachment complete. */ 


{Get info on attached printer from printer_info.] 
{call ioi_ to set up [/U environment.] 
(Perform I/Q on device.] 
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PLANNED EXTENSIONS 


It is hoped that witnin the framework of the interfaces 
‘described in this oe many significant improvements can and 
will he made to rep_ Below is a partial list of some of these 
enhancements. They are in no special order. 


1. Support for the long wait case of rcp _$check_assign and 
rep_$check_attach. This involves’ solving all of the 
deadlocking problems that can occur with competing 
processes. | 


2. Implementation of an entry point that will perforn the 
assignment of two or more devices. 


3. Implementation of an entry point that will perform the 
assignment of one or more volumes. Corresponding to 
this will be support for a disposition value that 
specifies that both the device and volume are to remain 
assigned and support for a disposition value that 
specifies that the device is to be unassigned but the 
volume is to remain assigned. 


4. Implementation of an entry ee that will set’ the 
disposition of a device. 


5. Implementation of a tape’ mount entry point. This will 
allow the functions of attachment and mounting to be 
separated. This also implies that detachment’ and 
dismounting may be separated. 


6. Implementation of device and volume reservation. 
Reservation is different from assignment. Reservation 
involves defining a time period, possibly in the 
future, in which a resource may be assigned to only the 
specified user. The resource will be unavailable to 
all other users during that time period. 


7. Full implementation of tape reel management. This will 
include registration of tape reel data, access control 
lists for eacn tape reel, Operator authentication of 
tape mounts, label checking, etc. 


8. Improved access control over the assignment of devices. 
This might include access control lists for each 
device. It might. include bringing the assignment of 
devices under the control of the access isolation 
mechanism by associating an access level with each 
device. It might also include operator authorization 
of device assignments and attachments. 
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9. Implementation of accounting for device and volume - 
reservations, assignments, and attachments. 


10. Implementation of points 6, 7, 8, and 9 above may 
result in the initializer process or some other system 
process being used to perform many of the functions of 
Peps 


Il. Development of the capability to set limits on _ the 
length of time that a process may have a device or 
volume assigned. This time limit could vary depending 
upon. the resource involved and the user involved. 


12. Development of the capability to sei different ioi_ 
limits for different users. 


13e Development of a complete set of device list and device 
status entry points. 


14. The partial, or possibly complete, replacement of 
ioam_. 


15. Support for disks as a new device class. 


16. Implementation of commands that will reserve, assign, 
and mount devices and volumes. 
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— Appendix A 
ioi_ Limits 
Device Class Max_iorkspace Max Time-Out 
tape 3K 5 minutes 
printer IK : 30 seconds 
punch | 1K 30 seconds 
reader IK 30 seconds 


console 1K 3 minutes 


